home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / ijb14b1.zip / README.OS2 < prev    next >
Text File  |  1997-08-20  |  4KB  |  71 lines
  1. This is the README for the OS/2 version of Junkbuster 1.4 beta 1
  2. For general informations about Junkbuster consult the file README.
  3.  
  4. This version of Junkbuster was 'ported' from the original unix version.
  5. It wasn't really a port, because with the wonderful EMX library and the 
  6. GNU C-Compiler it was an easy task.
  7.  
  8. After unpacking the Zip-archiv (on a HPFS-drive) you will find the following files:
  9.   bin\junkbuster.exe - The OS/2 executable version of Junkbuster
  10.   bin\junk.cmd       - Command file which invokes junkbuster.exe with options
  11.   blockfile          - a sample blockfile
  12.   cookiefile         - a sample cookiefile
  13.   README             - the original README
  14.   junkbuster.1       - the manual as a UNIX manpage
  15.   gpl.html           - GNU General Public Licence
  16.   ijbfaq.html        - Manual for the Internet Junkbuster, HTML format
  17.   ijbman.html        - Frequently Asked Questions on the Internet Junkbuster
  18.   blockfile.org      - the original provided blockfile
  19.   README.OS2         - guess, you read it
  20.   source.zip         - the source code
  21.  
  22. Changes on the orginal source:
  23.  
  24. * added compile and linker-options for OS/2 EMX to the 'Makefile'
  25. * added '#include <sys/param.h>' with appropriate #ifdef's to 'socks4.c'
  26. * made a cosmetic change to 'jcc.h' to report version as 'IJ/1.4 OS/2'
  27. * changed the default user-agent in 'jcc.c' from the macintosh default to 
  28.   'User-Agent: Mozilla/3.0 (OS/2; I)' (as the actual Navigator for OS/2 reports)
  29.  
  30. Additional the rx-library 'ftp://prep.ai.mit.edu/pub/gnu/rx-1.5.tar.gz'
  31. was compiled for OS/2 EMX to make the regular expressions in the blockfile
  32. available (for more informations look at the makefile).
  33.  
  34. The OS/2 executable version of Junkbuster can be found in the subdirectory 'bin'.
  35. There you can also find the file 'junk.cmd' as an example on how to invoke
  36. the junkbuster. For further configuration options consult the files
  37. 'ijbfaq.html' and 'ijbman.html'.
  38.  
  39. Installation is very easy. Adjust the parameters (mainly the -f option) in
  40. 'junk.cmd' then start it. For regular use you should add this file to the
  41. startup folder of OS/2. Now open your Netscape Navigator and enter as the
  42. 'HTTP-Proxy' and 'Security-Proxy': 'HTTP://127.0.0.1' Port: '8000'.
  43. For the IBM-WebExplorer enter in the field 'Proxy-Gateway':
  44. 'http://127.0.0.1:8000/'.
  45. To test the correct installation enter the URL 'http://127.0.0.1/show-proxy-args'
  46. Now you should see the status page of Junkbuster. If this doesn't work for you
  47. check if Junkbuster is really runnning (open windowlist) and if you entered
  48. the correct options for the proxy.
  49.  
  50. I renamed the original delivered 'blockfile' to 'blockfile.org'. Look there
  51. for a short description on how to block URL's and images. As a 'real' blockfile
  52. I included 'blockfile' with the definitions found on 'www.junkbuster.com'.
  53. For a complete description on how to configure the blockfile consult the
  54. manual 'ijbman.html'. Cookies are always blocked. But you can allow cookies
  55. from specific sites by adding them to 'cookiefile'. For more informations look
  56. at this file or the manual.
  57.  
  58. The port was done on 1997/08/20 by Gerd Flender.
  59. The program was tested under OS/2 Warp 4 with Netscape/2 2.02 and IBM WebExplorer,
  60. but it should run with no problem under Warp 3 and Warp 3 Connect.
  61. I release it with the status of a beta, because I only tested it under the
  62. above configuration and only for a few days (I could not find any problems :)
  63. So if you use this programm with a different configuration I would like to
  64. hear your experiences. I would also like to know if there is a need for a
  65. PM-frontend for configuring the Junkbuster. Maybe I find the time to write one.
  66.  
  67. For bug-reports, more informations or your comments regarding the OS/2 version
  68. of Junkbuster mail to 'plgerd@informatik.uni-siegen.de'
  69. For general informations about Junkbuster look at 'http://www.junkbuster.com'
  70.  
  71.